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The OCCaM 2 Toolset 


The code collector which creates bootable files from linked units 
or configuration binary files. 


icollect 


icvemit 


icvlink 


idebug 


idump 


iemit 


ieprom 


ilibr 


1link 


itlist 


imakef 


iserver 


isim 


iskip 


oc 


occon£t 
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Memory interface file convertor. Converts files produced by 
iemi (a previous version of iemit) to a format suitable for 
use with Leprom and iemit. 


The TCOFF file convertor which converts LFF object files to 
TCOFF format. 


The network debugger which provides post-mortem and interac- 
tive debugging of transputer programs. 


The memory dumper for saving the program image on the root 
transputer. 


The transputer memory configurer for evaluating and defining 
memory configurations. 


The EPROM program formatter tool which generates transputer 
bootable code for input to ROM programmers. 


The toolset librarian which builds libraries of compiled code. 


The toolset linker which links separately compiled code into a 
single file. 


The binary lister which displays information from toolset object 
files. 


The Makefile generator which generates Makefiles for input to 
MAKE programs. 


The host file server which loads programs onto transputer hard- 
ware and provides host communication. 


The T425 simulator. Simulates program execution on an IMS 
T425 transputer. 


The skip loader tool which loads over the root transputer. 


The OCCam 2 compiler. Generates object code for specific 
transputer targets. 


The configurer which creates configuration binary files from con- 
figuration descriptions. 
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Default file extensions 


a Description 


Bootable code file. Created by icollect. 


Executable code minus bootstrap information used for input 
to ieprom. Created by icollect. 


Configuration binary file. Created by occonf or 
icollect. 


Configuration object file. Created by occonf. 


Core-dump file created by idump or network-dump file cre- 
ated by idebug or isin. 


Include file. Input to oc and occonf. 

Linked unit. Created by ilink. 

Library build file. Command file for ilibr. 

Library file. Created by ilibr. 

Library usage file. Created by imakef. 

Linker indirect file. Command file for ilink. 

OcCaM 2 source files. 

Configuration description source file. 

Dynamically loadable code file. Created by icollect. 
Compiled code file. Created by oc. 
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4 Tools 


1collect — code collector 


Generates bootable code files for single and multiple transputer programs from 
linked units and configuration binary files respectively. Also used to create non- 
bootable single transputer programs for dynamic loading or booting from ROM. 


Syntax: icollect filename {options} 


where: filename is a linked unit (.1ku) or configuration binary file (. c£b). 


Note: If the input file is a linked unit (single transputer mode) then the ‘T’ option 
must be specified. 


gram. 
Pesce 

transputer programs. 
[=| Changes setng of Halt On Eror fag. 
[=| Displays progress information, 
[x | Creates non-bootsrapped code, 
fea ___| Greates RAMoadable code, 
[no __| Creates ROMoadable code. 

sor. 

gle transputer programs. 
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fe Creates bootable code for a single transputer. 


Loads transputer-hosted tool for multiple execu- 
tion. 


Loads transputer-hosted tool for single execu- 
tion. 

Y Disables interactive debugging with idebug for 
single transputer programs. 


Options: 
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icvemit-— memory interface 
convertor 


Converts memory configuration files produced by iemi (a previous version of 
iemit) to a file format suitable for use with Lemit and ieprom. 


Syntax: icvemit filename {options} 


where: filename is the input file to be converted. 


Options: a Displays progress information. 
Specifies output file. 
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1¢cvlink-— object code convertor 
Converts object code into TCOFF format. 
Syntax: icvlink filename {options} 


where: filename is the object file to be converted. 


Options: Creates multiple modules from TA and TC 
modules. For libraries only. 


Loads transputer-hosted tool for multiple ex- 
ecution. 


Loads transputer-hosted tool for single exe- 
cution. 
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8 Tools 


1debug-— network debugger 


Provides post-mortem debugging and breakpoint debugging. 
Syntax: idebug filename {options} 


where: filename is a bootable file. 


Breakpoint debug a network. 


M linknumber | Postmortem debug a previous breakpoint 
session. 

tT /inknumber | Postmortem debug a program not using the 
root processor. 

R filename Postmortem debug a program using the 
root transputer. 

N filename Postmortem debug from a network dump 
file. 

C type Specify processor type instead of class for 
non-configured programs. 


Dummy debugging session. 
Assert subsystem analyse on the network. 


Ignore subsystem error status when break- 
point debugging. 


Display debugger version number. 


Options: 
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Tools 9 


1dump-— memory dumper 


Writes the root transputer’s memory to a file. Used in debugging programs that 
use the root transputer. 


- Syntax: idump filename memsize {offset length} 
where: filename is the bootable program file 
an memsize is the amount of memory measured in bytes to be dumped to 
the file 
= Offset is a byte offset from the start of memory 
am length is the number of bytes of memory starting at offset to be written 
| to the file in addition to memsize. 
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10 Tools 


iemit-— memory configurer 


Evaluates memory configurations. 


Syntax: iemit {options} 
Options: 


Zo Invoke interactive mode. 


fe Displays progress information. 
[> | ProsicePostSarpt out fia. 
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1eprom-— EPROM program 
convertor 


Formats bootable code for installation by ROM loaders. 


Syntax: ieprom filename {option} 


where: filename is the control file. 


Options: [2 | Displays progress information, 
= 
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Tools 


tlibr - librarian 


Builds libraries of code from separate files. 


Syntax: 


ilibr {filenames} {options} 


where: filenames is a list of compiled modules. 


Options: 
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[Diss progress intonation 


Loads transputer-hosted tool for multiple ex- 
ecution. 


Loads transputer-hosted tool for single exe- 


cution. 
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13 


tLlink- linker 


Links object files together, resolving external references, to create a single linked 


unit. 


Syntax: 


ilink {filenames} {options} 


where: filenames is a list of compiled modules or libraries. 


Options: 
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(T400/T 41 4/T425/T800/T801/T805). 

[ee [Link or cass To (Ta00rravsTa25). 
[a2 [Unk tor Tavartaoeneis 
[e223 |Link or 7222, 
[e228 [Link 7225. 
fea [UnkforT205, SSS 
[e400 | 


fra [Linktortera 
[a2 | nk forT425, 
fas [Link for Teasrrag, 


fee [Link tor Te00. SSS 
[605 [ink tor Te05. SSS 
fas [Link tor Teowre0s SS 
[a__[ Generales HALT mode output. Defauk 
i) 
ca 


Generates STOP mode output. 
Generates UNIVERSAL mode output. 
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Options: eo Specifies TCOFF format. Default. 


Specifies LFF format. For use with the 
iboot and iconf tools, supported by the 
D705, D605 and D505 toolsets. 
LC Specifies LFF format. As above, but 

only for use with the iconf tool. 
Allows extraction of modules without 
linking them. 

Specifies linker indirect file. 

Ee Displays progress information. 


KB memorysize | Specifies maximum internal code buffer 
size. 


Allows unresolved references. 


Loads transputer-hosted tool for multiple 
execution. 


Loads transputer-hosted tool for single 
execution. 


Disables interactive debugging for OC- 
CaM code. 
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11ist-— binary lister 
Decodes and displays information from object files and bootable files. 
Syntax: ilist filename {options} 


where: filename is an object or bootable file. 


Options: fa Displays all available symbolic information. 
Displays code in hexadecimal. 
Displays all exported names. 


Displays specified file(s) in hexadecimal 
format. 


si Displays full progress information. 


> [Dias procedural ieraces 


R reference | Displays library module(s) with the speci- 
fied reference. 
Displays full listing. 
Identifies file type. Default. 


ie Displays all external references. 
= | Loads transputer-hosted tool for multiple 


execution. 


Loads transputer-hosted tool for single ex- 
ecution. 
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imakef-— Makefile generator 
Creates Makefiles for toolset compilations. 
Syntax: imakef {filenames} {options} 
where: filenames is a list of target object or bootable files. 


For C modules only. Specifies input from a 
linker indirect file. 


Options: 


| . | 
oe Disables debugging data. 

| Displays full progress information. 
nates 


Specifies output file 


Loads transputer-hosted tool for multiple ex- 
ecution. 


= | Loads transputer-hosted tool for single exe- 


cution. 


Disables interactive (breakpoint) debugging in 
the target file. 
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1server-— server/loader 


Loads programs onto transputers and transputer boards and serves host com- 
munications. 


Syntax: iserver bootablefile {options} 


where: bootablefile is a bootable file. 


Options: 


Displays progress information. 


Specifies device name or link address. 


Specifies KBytes of memory peeked on Anal- 
yse. 


Resets root transputer and subsystem on the 
link. 


Serves the link, that is, starts up the host com- 
munications. 


Option SB is equivalent to invoking the combination 
SR SS SI SC filename. 
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LSim-— 1425 simulator 


Simulates the execution of a program on the IMS T425. 
Syntax: isim filename programparameters {options} 


where: filename is a bootable file. 


[a [Batch node operion 
av [Bath Veriymede, 


Options: 
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1skip- skip loader 


Allows programs to be loaded onto transputer networks beyond the root trans- 
puter. 


Syntax: iskip linknumber {options} 


where: linknumber is the root transputer link to which the target network is 


connected. 
Monitors subsystem error status; terminates when 
it becomes set 


Reset subsystem but not the root transputer. 
Displays detailed progress information. 


Options: 
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Tools 


OC— occam 2 compiler 


Compiles OCCamMm 2 source code. 


Syntax: 


oc filename {options} 


where: filename is an OCCaM source file. 


Options: 
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| racoreeraressrecorsorreos,. 
(T400/T 41 4/T425/T800/T801/T805). 

[a2 | Compile or Tararrazonioia 
[222 | Compile orT222, 
[225 | Compile or 1225. SS 
[400 | Compile or 1400. 
fra [ Compile tora 
fm425 [Compile for T425. 
fas | Compite tor Te257Ta00, 
fr | Compile or 7800. 


feos | Compile or 7808. SSCS™S 
[r9___| Compile for Te017T805. SS 
[# | Generates HALT mode output. Default. 


Enables use of ASM or GUY code for a re- 
stricted set of transputer instructions. 


Enables use of ASM or GUY code for the full 
set of transputer instructions. 
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Options: 
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Disables insertion of run-time range checks. 
Disables insertion of run-time error checks. 


Disables insertion of run-time checks for 
ASSERTS. 


Loads the tool and terminates. 


Loads transputer-hosted tool for multiple ex- 
ecution. 


Loads transputer-hosted tool for single exe- 
cution. 


rate vector space requirement. 


Disables warning messages of unused pa- 
rameters. 

Disables warning messages of unused vari- 
ables or routines. 


Provides a warning when a name is de- 
scoped. 


Provides a warning when a run-time alias 
check is generated. 
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occonef£-configurer 


Generates configuration binary files frrom configuration descriptions. 
Syntax: occonf filename {options} 


where: filename is a configuration description (. pgm) source file. 


ee Displays messages in brief. 

Only performs check 
fa Displays progress information. 
I 


Options: 


O outputfile Specifies output file 
Redirects error messages to a file. 
V Disables the generation of code with a 
separate vector space requirement. 


Disables interactive debugging with 
idebug. 


Creates RAM-loadable code. 
Creates ROM-loadable code. 
Generates HALT mode output. Default. 


fe Generates STOP mode output 


Loads the tool and terminates. 


Generates UNIVERSAL mode output. 


Disables insertion of run-time range 
checks. 


Disables insertion of run-time error 
checks. 


Disables insertion of run-time checks for 
ASSERTs. 
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Enables use of ASM or GUY code for a re- 
stricted set of transputer instructions. 
Enables use of ASM or GUY code for the full 
set of transputer instructions. 

Enables memory lay-out re-ordering. 
Disables warning messages of unused pa- 
rameters. 


Disables warning messages of unused vari- 
ables or routines. 
aa Provides a warning when a name is de- 


scoped. 


Provides a warning when a run-time alias is 
check is generated. 


Loads transputer-hosted tool for multiple ex- 
ecution. 


Loads transputer-hosted tool for single exe- 
cution. 
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Debugger commands 


Debugger symbolic functions 


Inspect symbol. 


t Change variable in memory. 


¢ Breakpoint mode only 
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Debugger Monitor page commands 


y| Meaning [Description 


A 
@ 


[spect any ype 


| Quit | Quit debugger. 
[Ext | Change to symboliomode. 
[Hep [Display ep information. 


Breakpoint mode only 


4-F 


ie 


++ 
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Debugger Monitor page commands (contd) 


[sectdeniy, 
[seconde SSS 
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Simulator commands 


[weaning [Bescipton 
ee 
whe 


# Batch mode commands. 


|] 9 =| cr |c A 
= 2 


a 


DY jr 
m 
— 
Uv 


EFRES 


a 


INIS 


ne 
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Libraries 


Include files 


Host file server constants 
Stream i/o constants 
Maths and trigonometric constants 


linkaddr.inc | Transputer link addresses. 


Rates of the two transputer clocks 
DOS specific hostio library constants 


Compiler libraries 


[Fie Prosessorype 


The compiler libraries support all error modes. occamut1.1ib contains rou- 
tines called by some of the other compiler libraries. virtual .1ib supports 
interactive debugging. 


Bit manipulation functions 


)Result | Function —| Parameter Specifiers 


BITCOUNT VAL INT Word, CountiIn 


BITREVNBITS | VAL INT x, n 
BITREVWORD | VAL INT x 
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2D block moves 


Parameter Specifiers 


CLIP2D [] []BYTE Source, 
INT sx, sy, [] []BYTE Dest, 
INT dx, dy, width, length 


[] [] BYTE Source, 
INT sx, sy, [][]BYTE Dest, 
INT dx, dy, width, length 


{[] [] BYTE Source, 
INT sx, sy, [][]BYTE Dest, 
INT dx, dy, width, length 


CRC functions 


Result | Function _ Parameter Specifiers 


CRCWORD | VAL INT data, CRCIn, 
generator 


CRCBYTE | VAL INT data, CRCIn, 
generator 


Supplementary arithmetic support functions 


|Result(s) | Function | Parameter specifiers 


FRACMUL | VAL INT x, y 
UNPACKSN | VAL INT x 


ROUNDSN | VAL INT Yexp, Yfrac, 
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Hostio library #USE "hostio.1lib" 


CHAN OF SP fs, ts, 

VAL []BYTE prompt, replies, 

VAL BOOL display.possible.replies, 
VAL BOOL echo.reply, 

INT reply.number 


fam 
(Amy 
(am 
Procedure Parameter Specifiers 
fam, 
(am 


Am, 
so.buffer CHAN OF SP fs, ts, 
~ from.user, to.user, 
CHAN OF BOOL stopper 
Aan so.close CHAN OF SP fs, ts, 
VAL INT32 streamid, 
BYTE result 
fa, 
so.commandline CHAN OF SP fs, ts, VAL BYTE all, 
Am INT length, []BYTE string, 
BYTE result 
laa so.core CHAN OF SP fs, ts, 
VAL INT32 offset, INT bytes.read, 
Ps []BYTE data, BYTE result 


so.date.to.ascii | VAL [so.date.len]INT date, 
(a, VAL BOOL long.years, 
VAL BOOL days.first, 
[so.time.string.len]BYTE string 


so.eof CHAN OF SP fs, ts, 
Am VAL INT32 streamid, BYTE result 


so.exit CHAN OF SP fs, ts, 
VAL INT32 status 


(am 
so.ferror CHAN OF SP fs, ts, 
as VAL INT32 streamid, 
INT32 error.no, INT length, 
fam []BYTE message, BYTE result 


CHAN OF SP fs, ts, 
(am VAL INT32 streamid, 
BYTE result 
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Procedure Parameter Specifiers 


CHAN OF SP fs, ts, 
VAL INT32 streamid, 
VAL BYTE char, BYTE result 


so.fwrite.char 


so.fwrite.hex.int CHAN OF SP fs, ts, 
VAL INT32 streamid, 


VAL INT n, width, BYTE result 


so.fwrite.hex.int32 | CHAN OF SP fs, ts, 
VAL INT32 streamid, n, 


VAL INT width, BYTE result 


so.fwrite.hex.int64 | CHAN OF SP fs, ts, 
VAL INT32 streamid, VAL INT64 n, 


VAL INT width, BYTE result 


so.fwrite.int CHAN OF SP fs, ts, 
VAL INT32 streamid, 


VAL INT n, field, BYTE result 


so.fwrite.int32 CHAN OF SP fs, ts, 
VAL INT32 streamid, VAL INT32 n, 


VAL INT field, BYTE result 


so.fwrite.int64 CHAN OF SP fs, ts, 
VAL INT32 streamid, VAL INT64 n, 


VAL INT field, BYTE result 


so.fwrite.nl CHAN OF SP fs, ts, 


VAL INT32 streamid, BYTE result 


so.fwrite.real32 CHAN OF SP fs, ts, 
VAL INT32 streamid, 
VAL REAL32 r, VAL INT Ip, Dp, 


BYTE result 


so.fwrite.real64 CHAN OF SP fs, ts, 
VAL INT32 streamid, 
VAL REAL64 r, VAL INT Ip, Dp, 


BYTE result 


so.fwrite.string CHAN OF SP fs, ts, 
VAL INT32 streamid, 


VAL []BYTE string, BYTE result 


so.fwrite.string.nl|CHAN OF SP fs, ts, 
VAL INT32 streamid, 


VAL []BYTE string, BYTE result 
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Libraries 


Procedure 


so.getenv 


so.getkey 


so.gets 


so.multiplexor 


so.open.temp 


so.overlapped.buffer 


so.overlapped.multiplexor 


so.overlapped.pri.multiplexor 
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Parameter Specifiers 


CHAN OF SP fs, ts, 
VAL [] BYTE name, 


INT length, 
BYTE result 


[]BYTE value, 


CHAN OF SP fs, ts, 
BYTE key, result 


CHAN OF SP fs, ts, 
VAL INT32 streamid, 


INT length, 
[JBYTE data, 


BYTE result 


CHAN OF SP fs, ts, 


[]CHAN OF SP 


from.user, to.user, 
CHAN OF BOOL stopper 


CHAN OF SP fs, ts, 
VAL []BYTE name, 
VAL BYTE type, mode, 
INT32 streamid, 


BYTE result 


CHAN OF SP fs, ts, 

VAL BYTE type, 
[so.temp.filename.length] 
BYTE filename, 

INT32 streamid, 


BYTE result 


CHAN OF SP fs, ts, 
from.user, to.user, 
CHAN OF BOOL stopper 


CHAN OF SP fs, ts, 


[]CHAN OF SP 


from.user, to.user, 
CHAN OF BOOL stopper, 


[J INT queue 


CHAN OF SP fs, ts, 


[]CHAN OF SP 


from.user, to.user, 
CHAN OF BOOL stopper, 


[J INT queue 


March 1991 


34 


Procedure 


so.parse.command.line 


so.pollkey 


so.popen.read 


so.pri.multiplexor 


so.puts 


so.read 


.read.echo.any.int 


-read.echo.hex.int 


.read.echo.hex.int32 


.read.echo.hex.int64 


so.read.echo.int 


so.read.echo.int32 
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Parameter Specifiers 


CHAN OF SP fs, ts, 

VAL [] [] BYTE option.strings, 
VAL []INT 
option.parameters.required, 
[]BOOL option.exists, 

[J] [2] INT option.parameters, 
INT error.len, []BYTE line 


CHAN OF SP fs, ts, 
BYTE key, result 


CHAN OF SP fs, ts, 

VAL []BYTE filename, 

VAL [] BYTE 
path.variable.name, 

VAL BYTE open.type, 

INT full.len, 

[]BYTE full.name, 

INT32 streamid, BYTE result 


CHAN OF SP fs, ts, 
[]CHAN OF SP 
from.user, to.user, 
CHAN OF BOOL stopper 


CHAN OF SP fs, ts, 
VAL INT32 streamid, 
VAL []BYTE data, BYTE result 


CHAN OF SP fs, ts, 
VAL INT32 streamid, 
INT length, []BYTE data 


CHAN OF SP fs, ts, INT n, 
BOOL error 


CHAN OF SP fs, ts, INT n, 
BOOL error 


CHAN OF SP fs, ts, INT32 n, 
BOOL error 


CHAN OF SP fs, ts, INT64 n, 
BOOL error 


CHAN OF SP fs, ts, INT n, 
BOOL error 


CHAN OF SP fs, INT32 n, 
BOOL error 
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Procedure Parameter Specifiers 


so.read.echo.int64 | CHAN OF SP fs, ts, INT64 n, 
BOOL error 


CHAN OF SP fs, ts, INT len, 
[]BYTE line, BYTE result 


so.read.echo.line 


CHAN OF SP fs, ts, REAL32 n, 
BOOL error 


CHAN OF SP fs, ts, REAL64 n, 
BOOL error 


CHAN OF SP fs, ts, INT len, 
{]BYTE line, BYTE result 


CHAN OF SP fs, ts, 
VAL []BYTE name, BYTE result 


so.read.echo.real32 


so.read.echo.real64 


so.read.line 


so.remove 


CHAN OF SP fs, ts, 
VAL []JBYTE oldname, newname, 
BYTE result 


so.rename 


CHAN OF SP fs, ts, 

VAL INT32 streamid, 

VAL INT32 offset, origin, 
BYTE result 


CHAN OF SP fs, ts, 
VAL []BYTE command, 
INT32 status, BYTE result 


CHAN OF SP fs, ts, 
VAL INT32 streamid, 
INT32 position, BYTE result 


so.seek 


so.system 


so.tell 


CHAN OF SP fs, ts, 
VAL []BYTE filename, BOOL exists 


so.test.exists 


CHAN OF SP fs, ts, 
INT32 localtime, UTCtime 


so.time 


VAL INT32 time, 

VAL BOOL long.years, 

VAL BOOL days.first 
[so.time.string.len]BYTE string 


so.time.to.ascil 


so.time.to.date 


VAL INT32 input.time, 
[so.date.len]INT date 


72 TDS 199 01 March 1991 


36 Libraries 


Procedure Parameter Specifiers 


so.today.ascii CHAN OF SP fs, ts, 
VAL BOOL long.years, days.first, 
[so.time.string.len]BYTE string 


CHAN OF SP fs, ts, 
[so.date.len]JINT date 


CHAN OF SP fs, 
BYTE version, host, os, board 


CHAN OF SP fs, ts, 
VAL INT32 streamid, 
VAL []BYTE data, 

INT length 


CHAN OF SP fs, ts, VAL BYTE char 


so.today.date 


so.version 


so.write 


so.write.char 


so.write.hex.int CHAN OF SP fs, ts, 


VAL INT n, width 


so.write.hex.int32 | CHAN OF SP fs, ts, 


VAL INT32 n, VAL INT width 


CHAN OF SP fs, ts, 
VAL INT64 n, VAL INT width 


CHAN OF SP fs, ts, 
VAL INT n, field 


CHAN OF SP fs, ts, 
VAL INT32 n, VAL INT field 


CHAN OF SP fs, ts, 
VAL INT64 n, VAL INT field 


CHAN OF SP fs, ts 


so.write.hex.int64 


so.write.int 


so.write.int32 


so.write.int64 


nl 
real32 


so.write 


so.write. 


CHAN OF SP fs, ts, 
VAL REAL32 xr, VAL INT Ip, Dp 


CHAN OF SP fs, ts, 
VAL REAL64 r, VAL INT Ip, Dp 


CHAN OF SP fs, ts, 
VAL []BYTE string 


so.write.real64 


so.write.string 


so.write.string.nl|CHAN OF SP fs, ts, 


VAL []BYTE string 
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Streamio library #USE "streamio.1ib" 


Procedure Parameter Specifiers 


ks .keystream.sink CHAN OF KS keys 


ks .keystream.to.scrstream | CHAN OF KS keyboard, 
CHAN OF SS scrn 


ks .read.char CHAN OF KS source, 
INT char 


> DDD ?D D 


ks .read.int CHAN OF KS source, 
INT number, char 


ks .read.int64 CHAN OF KS source, 
INT64 number, INT char 


) 


ks .read.line CHAN OF KS source, 
INT len, []BYTE line, 
INT char 


3 


) 


ks .read.real32 CHAN OF KS source, 
REAL32 number, INT char 


ks .read.real64 CHAN OF KS source, 
REAL64 number, INT char 


so.keystream. from. file CHAN OF SP fs, ts, 
CHAN OF KS keys.out, 
VAL []BYTE filename, 
BYTE result 


so.keystream. from.kbd CHAN OF SP fs, ts, 
CHAN OF KS keys.out, 
CHAN OF BOOL stopper, 
VAL INT ticks.per.poll 


so.keystream.from.stdin CHAN OF SP fs, ts, 
CHAN OF KS keys.out, 
BYTE result 


CHAN OF SS scrn 


fam 
= 
fam, so.scrstream.to.ANSI CHAN OF SP fs, ts, 
am 
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Procedure 


so.scrstream.to.file 


so.scrstream.to.stdout 


so.scrstream.to.TVI920 


ss .beep 
ss.clear.eol 
ss.clear.eos 
ss.del.line 
ss.delete.chr 
ss.delete.chl 
ss .down 


ss.goto.xy 


ss.ins.line 
ss.insert.char 


ss.left 


ss.right 


ss.scrstream.copy 


ss.scrstream.fan.out 


ss.scrstream.from.array 


ss.scrstream.multiplexor 


ss.scrstream.sink 
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Parameter Specifiers 


CHAN OF SP fs, ts, 
CHAN OF SS scrn, 
VAL []BYTE filename, 
BYTE result 


CHAN OF SP fs, ts, 
CHAN OF SS scrn, BYTE result 


CHAN OF SP fs, ts, 
CHAN OF SS scrn 


CHAN OF SS scrn 
CHAN OF SS scrn 
CHAN OF SS scrn 
CHAN OF SS scrn 
CHAN OF SS scrn 
CHAN OF SS scrn 
CHAN OF SS scrn 


CHAN OF SS scrn, 
VAL INT x, y 


CHAN OF SS scrn 
CHAN OF SS scrn, VAL BYTE ch 
CHAN OF SS scrn 
CHAN OF SS scrn 
CHAN OF SS secrn.in, scrn.out 


CHAN OF SS scrn, 
screen.outl, 
screen .out2 


CHAN OF SS scrn, 
VAL []BYTE buffer 


[]CHAN OF SS screen.in, 
CHAN OF SS screen.out, 
CHAN OF INT stopper 


CHAN OF SS scrn 


March 1991 


pam 


Libraries 


39 


Procedure Parameter Specifiers 


ss.scrstream.to.array | CHAN OF SS scrn, 
[J BYTE buffer 


Ss .up CHAN OF SS scrn 


ss.write.char CHAN OF SS scrn, VAL BYTE char 


ss.write.endstream CHAN OF SS scrn 


ss.write .hex.int CHAN OF SS scrn, 
VAL INT number, field 


ss.write.hex.int64 CHAN OF SS scrn, 
VAL INT64 number, 
VAL INT field 


Ss.write.int CHAN OF SS scrn, 
VAL INT number, field 


ss.write.int64 CHAN OF SS scrn, 
VAL INT64 number, 
VAL INT field 


ss .write.nl CHAN OF SS scrn 


ss.write.string CHAN OF SS scrn, VAL []BYTE str 


ss .write.real32 CHAN OF SS scrn, 
VAL REAL32 number, 
VAL INT Ip, Dp 


Sss.write.real64 CHAN OF SS scrn, 
VAL REAL64 number, 
VAL INT Ip, Dp 


Ss.write.text.line CHAN OF SS scrn, 
VAL []BYTE str 
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Single length maths library 
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REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 


REAL32, INT32 


REAL32 
REAL32 
REAL32 
REAL32 


AL REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 
REAL32 


Libraries 


#USE "snglmath.1lib" 


La OE Parameter specifiers 


REAL32 X, VAL REAL32 Y 


INT32 X 

REAL32 X 
REAL32 X 
REAL32 X 
REAL32 X 
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Double length maths library #USE "dblmath.1lib" 
fm, 
REAL64 DACOS AL REAL64 X 
an REAL64 DALOG REAL64 X 
REAL64 DALOG10 REAL64 X 
am REAL64 DASIN REAL64 X 
REAL64 DATAN REAL64 X 
fam REAL64 DATAN2 REAL64 X, VAL REAL64 Y 
REAL64 DCOSs REAL64 X 
ae REAL64 DCOSH REAL64 X 
REAL64 DEXP REAL64 X 
am REAL64 DPOWER REAL64 X, VAL REAL64 Y 
REAL64, INT64 | DRAN INT64 X 
” REAL64 DSIN REAL64 X 
REAL64 DSINH REAL64 X 
= REAL64 DTAN REAL64 X 
REAL64 DTANH REAL64 X 
‘ian 
se T400/T414/T425 maths library #usE "tbmaths.1ib" 
Am Contains the same functions as snglmath.1ib and dblmath.1ib, but op- 
timised for the IMS T400, IMS T414 and IMS T425 procesoors. 
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String library 


[Result |Function __| Parameter Specifiers 


BOOL 
BOOL 
INT, BYTE 


INT, BYTE 


INT 
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char.pos 


compare.strings 
egstr 

is.digit 
is.hex.digit 
is.id.char 


is.in.range 


is.lower 
is.upper 


search .match 


search.no.match 


string.pos 


Libraries 


#USE "string.1lib" 


BYTE search, 
[]BYTE str 


[]BYTE strl, str2 
[JBYTE s1,s2 
BYTE char 

BYTE char 

BYTE char 

BYTE char, 


bottom, top 


VAL 
VAL 


VAL 
str 


VAL 
str 


VAL 
str 


BYTE char 
BYTE char 
[]BYTE possibles, 


[]BYTE possibles, 


[]BYTE search, 
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pam 
pam Procedure Parameter Specifiers 
append.char len, []BYTE str, 
BYTE char 
append.hex.int len, []BYTE str, 
-_ INT number, field 
ae append.hex.int64 len, []BYTE str, 
| INT64 number, VAL INT width 
a append.int len, []BYTE str, 
INT number, field 
(am append.int64 len, []BYTE str, 
INT64 number, VAL INT field 
append.real32 len, []BYTE str, 
REAL32 number, 
fm INT Ip, Dp 
. append.real64 len, []BYTE str, 
sm REAL64 number, 
INT Ip, Dp 
aaa append.text len, []BYTE str, 
[]BYTE text 
ae delete.string len, []BYTE str, 
INT start, size, 
ar BOOL not.done 
insert.string VAL []BYTE new.str, 
ram INT len, []BYTE str, 
VAL INT start, BOOL not.done 
om next.int.from.line | VAL []BYTE line, 
INT ptr, number, BOOL ok 


next .word.from.line | VAL []BYTE line, 
INT ptr, INT len, 
[]BYTE word, BOOL ok 


str.shift [JBYTE str, 
on VAL INT start, len, shift, 
BOOL not.done 
sai to.lower.case [JBYTE str 
Ps to.upper.case [JBYTE str 
aN 
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Type conversion library #USE "convert.1lib" 


Parameter Specifiers | 


BOOLTOSTRING INT len, []BYTE string, 
HEXTOSTRING INT len, []BYTE string, om 
HEX1 6TOSTRING INT len, []BYTE string, 

HEX32TOSTRING | INT len, []BYTE string, a 
HEX6 4TOSTRING INT len, []BYTE string, 
INTTOSTRING INT len, []BYTE string, 
INT16TOSTRING INT len, []BYTE string, 
INT32TOSTRING | INT len, []BYTE string, 
INT64TOSTRING | INT len, []BYTE string, 


REAL32TOSTRING | INT len, []BYTE string, 
VAL REAL32 X, VAL INT Ip, Dp 


REAL64TOSTRING | INT len, []BYTE string, 
VAL REAL64 X, VAL INT Ip, Dp 


STRINGTOBOOL BOOL Error, b, VAL []BYTE string 
STRINGTOHEX BOOL Error, INT n, VAL []BYTE string 


STRINGTOHEX16 | BOOL Error, INT16 n, 
VAL []BYTE string 


STRINGTOHEX32 | BOOL Error, INT32 n, 
VAL []BYTE string 


STRINGTOHEX64 | BOOL Error, INT64 n, 
VAL []BYTE string 


STRINGTOINT BOOL Error, INT n, VAL []BYTE string 


STRINGTOINT16 | BOOL Error, INT16 n, 
VAL []BYTE string 


STRINGTOINT32 BOOL Error, INT32 n, 
VAL []BYTE string 


STRINGTOINT64 BOOL Error, INT64 n, 
VAL []BYTE string 


STRINGTOREAL32 | BOOL Error, REAL32 X, 
VAL []BYTE string 


STRINGTOREAL64 | BOOL Error, REAL64 X, 
VAL []BYTE string 


99) 9D DD YY Y 
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Block CRC library #USE "crce.1ib" 


/Resuit | Function Parameter Specifiers 


CRCFROMLSB | VAL []BYTE InputString 
VAL INT PolynomialGenerator, 
VAL INT Ol1dCRC 


CRCFROMMSB | VAL []BYTE InputString, 
VAL INT PolynomialGenerator, 


VAL INT Ol1dCRC 


Link handling library #USE "xlink.1lib" 


Procedure Parameter Specifiers 


InputOrFail.c | CHAN OF ANY c, []BYTE mess 
CHAN OF INT kill, BOOL aborted 


InputOrFail.t | CHAN OF ANY c, []BYTE mess, 
TIMER t, VAL INT time, BOOL aborted 


OutputOrFail.cj|CHAN OF ANY c, VAL []BYTE mess, 
CHAN OF INT kill, BOOL aborted 


OutputOrFail.t | CHAN OF ANY c, VAL []BYTE mess, 
TIMER t, VAL INT time, BOOL aborted 


Reinitialise CHAN OF ANY c 


72 TDS 199 01 March 1991 


46 Libraries 


Debugging support library #USE "debug.1ib" 


Parameter Specifiers 


DEBUG.ASSERT | VAL BOOL assertion 


DEBUG.MESSAGE | VAL []BYTE message 
DEBUG. STOP - 
DEBUG. TIMER CHAN OF INT stop 


Mixed languages support library #usE "callc.1ib" 


init.static [] INT static.area, INT 
required.size, gsb 


init .heap VAL INT gsb, [] INT 
heap.area 


terminate.heap.use VAL INT gsb 


terminate.static.use | VAL INT gsb 
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DOS specific hostio library #USE "msdos.1ib" 


Procedure 


dos .receive.block 


dos.send.block 


dos .call.interrupt 


dos .read.regs 


dos .port.read 


dos .port .write 


72 TDS 199 01 


Parameter Specifiers 


CHAN OF SP fs, ts, 

VAL INT32 location, 

INT bytes.read, []BYTE block, 
BYTE result 


CHAN OF SP fs, ts, 
VAL INT32 location, 
VAL []BYTE block, 
INT len, BYTE result 


CHAN OF SP fs, ts, 

VAL INT16 interrupt, 

VAL [dos.interrupt.regs.size] 
BYTE register.block.in, 


BYTE carry.flag, 
[dos.interrupt.regs.size] BYTE 
register .block.out, 

BYTE result 


CHAN OF SP fs, ts, 
[dos.read.regs.size] BYTE 
registers, 

BYTE result 


CHAN OF SP fs, ts, 
VAL INT16 port.location, 
BYTE value, result 


CHAN OF SP fs, ts, 
VAL INT16 port.location, 
VAL BYTE value, BYTE result 
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Libraries 


Compiler library user functions 


i 8 Parameter specifiers 


VAL REAL32 x 
VAL REAL32 x, y, y.err 


ARGUMENT . REDUCE 


ASHIFTRIGHT 
ASHIFTLEFT 

COP YSIGN 

DABS 
DARGUMENT . REDUCE 


DCOPYSIGN 
DDIVBY2 
DFLOATING . UNPACK 


DFPINT 
DIEEECOMPARE 
DISNAN 
DIVBY2 

DLOGB 
DMINUSX 
DMULBY2 
DNEXTAFTER 
DNOTFINITE 
DORDERED 
DSCALEB 
DSQORT 
FLOATING . UNPACK 


FPINT 


72 TDS 199 01 


REAL32 


INT32, 
REAL32 


INT 
INT 
REAL32 
REAL64 


BOOL, 
INT32, 
REAL64 


REAL64 
REAL64 


INT, 
REAL64 


REAL64 
INT 
BOOL 
REAL32 
REAL64 
REAL64 
REAL64 
REAL64 
BOOL 
BOOL 
REAL64 
REAL64 


INT, 
REAL32 


REAL32 


INT argument, places 
INT argument, places 
REAL32 x, y 

REAL64 x 

REAL64 x, 
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[Function | Result(s) | Parameter specifiers 
IEEE320P BOOL, REAL32 REAL32 x, 
INT rm, op, 
Amy REAL32 y 
IEEE32REM | BOOL, REAL32 REAL32 X, Y 
om IEEE640P BOOL, REAL64 REAL64 x, 
INT rm, op, 
REAL64 y 
IEEE64REM BOOL, REAL64 REAL64 X, Y 
am IEEECOMPARE | INT REAL32 x, y 
ISNAN BOOL REAL32 x 
an 
LOGB REAL32 REAL32 x 
a LONGADD INT INT left, right, 
carry.in 
PD LONGDIFF INT, INT VAL INT left, right, 
= borrow.in 
fm LONGDIV INT, INT VAL INT dividend.hi, 
_ dividend.lo, divisor 
pa LONGPROD INT, INT VAL INT left, right, 
= carry.in 
LONGSUB INT VAL INT left, right, 
borrow.in 
LONGSUM INT, INT VAL INT left, right, 
ne carry.in 
MINUSX REAL32 REAL32 x 
MULBY2 REAL32 REAL32 x 
am, NEXTAFTER REAL32 REAL32 x, y 
NORMALISE INT, INT, INT INT hi.in, lo.in 
am, NOTFINITE BOOL REAL32 x 


ORDERED BOOL REAL32 x, y 
REAL32EQ BOOL REAL32 x, y 


REAL32GT BOOL REAL32 x, y 


REAL320P REAL32 REAL32 x, VAL INT op, 
REAL32 y 
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Libraries 


Funetion | Result(s) _| Parameter specifiers 


REAL32REM REAL32 
REAL64EQ BOOL 
REAL64GT BOOL 
REAL640P REAL64 


REAL64REM REAL64 
ROTATELEFT | INT 
ROTATERIGHT | INT 
SCALEB REAL32 
SHIFTLEFT INT, INT 


VAL 
VAL 
VAL 
VAL 
VAL 
VAL 
VAL 
VAL 
VAL 
VAL 


SHIFTRIGHT | INT, INT 


SQRT REAL32 


REAL32 
REAL64 
REAL64 


REAL64 
REAL64 


REAL64 

INT argument, places 
INT argument, places 
REAL32 x, VAL INT n 


INT hi.in, lo.in, 


lo.in, 


Dynamic code loading support procedures 


LOAD .BYTE . VECTOR 

LOAD . INPUT . CHANNEL 

LOAD. INPUT. CHANNEL. VECTOR 
LOAD .OUTPUT . CHANNEL 


LOAD .OUTPUT . CHANNEL . VECTOR 
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Parameter Specifiers 


VAL []BYTE code, 

VAL INT entry.offset, 
[JINT workspace, 

VAL INT no.of.parameters 


INT here, 
[]BYTE bytes 


INT here, 
CHAN OF ANY in 


INT here, 
[]CHAN OF ANY in 


INT here, 
CHAN OF ANY out 


INT here, 
[]CHAN OF ANY out 
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Libraries 


Transputer error flag manipulation 


Procedure Parameter Specifiers 
CAUSEERROR | - 
ASSERT VAL BOOL test 


Rescheduling priority process queue 


Parameter Specifiers 
RESCHEDULE 
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